home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 001 / butler.arc / BUTLER.DOC < prev   
Text File  |  1985-07-29  |  6KB  |  124 lines
  1.  
  2.  
  3.                                                  July 27, 1985
  4.  
  5. Dear Modem users,
  6.  
  7. Here it is - ModemButler beta test version 1.0!  BUTLER.COM is the
  8. executable code form of ModemButler.  I hope you find it useful, and let
  9. me know your comments and suggestions for the program.  Since the full
  10. help facilities in ModemButler aren't completed yet, a bit of introduction
  11. and a command summary follow.
  12.  
  13. ModemButler does for communications what batch files do for DOS.  ModemButler
  14. will allow you to totally automate your communications with the outside world.
  15. You can dial until a connection is made, send and receive text at specific
  16. times, and transfer files automatically in Ascii, Xmodem, or Xmodem CRC
  17. protocols.  Another feature, not yet functioning, will allow you to specify
  18. ten responses to prompts from the remote system (such as RBBS-PC's More?
  19. prompt).  The entire communications language operates from a text file
  20. specified by you, the user, which instructs ModemButler what to do.  The whole
  21. communications session is specified in the text file - the user is not
  22. required to sit at the keyboard while the PC is communicating.  The PC will
  23. place all output from the remote system received in a text file with the same
  24. name as the instruction file, except with the extension of .HIS (for history
  25. file).  After the communications session is complete, you may view the file
  26. through the TYPE command, or from your favorite text editor.  A list of the
  27. commands that ModemButler will accept follows:
  28.  
  29. parameter conventions
  30. -----------------------------------------------------------
  31. {num}  is a number (must be specified)
  32.  
  33. {str}  is a string (numbers and letters) (also must be specified)
  34.  
  35. {char} is a one-character letter (also can't be omitted)
  36.  
  37. {filename} is a standard DOS filename
  38.  
  39. {time} is the desired time in HH:MM:SS format
  40.  
  41. / \ shows two or more options in which you must pick one, but not both
  42. \ /
  43.  
  44.  
  45. command summary
  46. -----------------------------------------------------------
  47. (note: commands may be typed in UPPER or lower case)
  48.  
  49. BAUD {num}                changes the baud rate (speed)
  50.                             (default is 1200)
  51.  
  52. CHAR DELAY {num}          defines the number of milliseconds to wait between
  53.                           transmissions of characters during an Ascii u/l
  54.                             (default is 0)
  55.  
  56. COM PORT {num}            changes communications port to num
  57.                             (default is 1)
  58.  
  59. DATA BITS {num}           changes data bits used in communications
  60.                             (default is 8)
  61.  
  62. DIAL / PULSE \ / ONCE          \  {str}    This will dial a Hayes-style modem
  63.      \ TONE  / \ UNTIL CONNECT /           with the number specified in {str}.
  64.                                            PULSE will dial ATDP, while TONE
  65.                                            will dial ATDT.  ONCE will dial
  66.                                            the number one time, while
  67.                                            UNTIL CONNECT will dial the number
  68.                                            until a modem CONNECT is received.
  69.  
  70. ECHO / ON  \              when on, will echo all output from PC to history file
  71.      \ OFF /              when off, won't echo PC's output to modem in history file
  72.                             (ON is the same as half duplex,  OFF is full duplex)
  73.                             (default is OFF)
  74.  
  75. HANG UP                   will send a +++ATH string to Hayes-style modems.
  76.  
  77. LINE DELAY {num}          number of milliseconds to wait between transmission
  78.                           of lines in an u/l using Ascii (no protocol)
  79.                             (default is 0)
  80.  
  81.  
  82.  
  83. PACING CHAR {char}        will cause ModemButler to wait for {char} between
  84.                           sending lines on an u/l using no protocol (ascii)
  85.  
  86.        / N \              changes parity to None (default)
  87. PARITY   E                changes parity to Even
  88.        \ O /              changes parity to Odd
  89.  
  90.               / ASCII      \              d/l's a file using no protocol
  91. RECEIVE USING   XMODEM CRC    {filename}  d/l's a file using Xmodem CRC
  92.               \ XMODEM     /              d/l's a file using Xmodem protocol
  93.  
  94. RESPOND TO {str} WITH {str}     not implemented yet....
  95.  
  96.      / CHAR {str}                     \   sends {str} over the modem
  97.        CR                                 sends a Carriage return
  98. SEND   LINE {str}                         sends {str} + a carriage return
  99.              / ASCII      \               u/l's a file using no protocol
  100.        USING   XMODEM CRC   {filename}    u/l's a file using Xmodem CRC
  101.      \       \ XMODEM     /           /   u/l's a file using Xmodem protocol
  102.  
  103. STOP BITS {num}           changes stop bits used in communications
  104.                             (default is 1 stop bit)
  105.  
  106.      / FOR {str}   \      waits until {str} is received from remote system
  107. WAIT   LINES {num}        waits for {num} CR's to be received from remote
  108.      \ TIME {time} /      waits until the system time is {time}
  109.  
  110. -----------------------------------------------------------
  111.  
  112. If you find anything that doesn't work the way you think it should, leave me
  113. a message on the RailRoad BBS (516-741-6914) or write/call me at:
  114.                         504 Glen Court
  115.                         Oceanside, New York 11572
  116.                         (516) 764-5248
  117. This is a freeware-type program, so give it to whomever you want.  By the
  118. way, this program was written in Turbo Pascal v3.0, using my own WinProc III
  119. windowing routines, and customized encarnations of Phillip R. Burns PIBASYNC
  120. code.  Hope ModemButler is helpful; let me know your comments.  Have fun!
  121.  
  122.  
  123.                                                 -- Andrew Brenner
  124.